home *** CD-ROM | disk | FTP | other *** search
/ InterCD 2000 August / augusty_2000.iso / Site Building / Ant_html / ant_demo.exe / ALT_INST.TXT < prev    next >
Encoding:
Text File  |  1997-01-03  |  13.9 KB  |  381 lines
  1.        TWO ALTERNATE INSTALLATION OPTIONS
  2.        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Clicking the red button in the ANT_INST.DOC file
  5. is easy and harmless but just opening the file
  6. causes scary warning messages on some systems.
  7. The README.TXT file contains more info about this.
  8.  
  9. Here are a couple of optional installation methods
  10. that you can use INSTEAD OF using the automatic
  11. procedure offered in the ANT_INST.DOC file.
  12.  
  13. These methods aren't as painless as just clicking the
  14. red button in the ANT_INST.DOC file, but they'll
  15. accomplish the same thing without having to go
  16. through seeing the horrid, scary Warning Messages
  17. that Microsoft has built into some MAC and WIN95
  18. systems when the ANT_INST.DOC file is merely
  19. opened in MS Word.
  20.  
  21. Regardless of which of the following options you
  22. choose...
  23.  
  24. 1.  Copy the ANT_DEMO.DOT file to whatever directory
  25.     you use to store your Word template (.DOT) files.
  26.     (Usually it's the WINWORD/TEMPLATE directory.)
  27.     
  28.     If you're not certain...
  29.     Look in your WINWORD6.INI file (WINDOWS directory)
  30.     There will be an entry for your USER-DOT-PATH which reads:
  31.     "USER-DOT-PATH=C:\WINWORD\TEMPLATE" or
  32.     "USER-DOT-PATH=D:\MSOFFICE\TEMPLATE" or
  33.     "USER-DOT-PATH=" + something
  34.  
  35.     This is where your .DOT files (Template files) are stored.
  36.  
  37. 2.  Copy the ANTDEMO.HTM file into the same directory.
  38.     (You can delete this file later if you want.  This
  39.     is the example HTML file that the HTML to WYSIWYG Tool
  40.     uses to demonstrate the conversion from HTML to .DOC.)
  41.  
  42. 3.  Create the "ANT_HTML.INI" file.
  43.     (This is the file that the program uses to keep track
  44.      of where things are and to record your preferences
  45.      when you use the tools which record those preferences.)
  46.     
  47.     Take a deep breath.  (This is the part the ANT_INST.DOC
  48.     red button makes painless and since you've opted not
  49.     to click the red button, here are the alternative options.)
  50.  
  51.     The ANT_HTML.INI file is a simple text file, named
  52.     "ANT_HTML.INI" and should be placed in your WINDOWS
  53.     directory.
  54.  
  55.     The file can be created with any simple text editor, like
  56.     Windows Notepad or Wordpad.  (It shouldn't be created with
  57.     a wordprocessor like MS Word, though, because wordprocessors
  58.     will add funny (and not so funny) codes and bungle up the
  59.     works.  If you MUST use a wordprocessor, be sure to save
  60.     the file in TEXT ONLY format.)
  61.  
  62.     All .INI files are basically simple text only files
  63.     and most of them contain a lot of text.  The ANT_HTML.INI
  64.     only requires eight lines of text. (Other entries will
  65.     be added later, but they'll be added automatically.  You
  66.     won't have to do anything or change anything.)
  67.  
  68.  
  69. ----- Example of content of ANT_HTML.INI FILE -------
  70.  
  71. [LocalizedStyleNames]
  72. LocalVersion=English (US)
  73. Normal=Normal
  74. Title=Title
  75. Heading=Heading
  76. Platform=Windows 3.10
  77. TemplatePath=c:\winword\template
  78. PathDivider=\
  79.  
  80. ----- End of Example of content of ANT_HTML.INI FILE -------
  81.  
  82.  
  83. After you've created a blank text file and have named it
  84. "ANT_HTML.INI" and placed it into your WINDOWS directory...
  85.  
  86. ````````````````````````````````````````````````````````````````````
  87.  
  88.              MANUAL CREATION OF THE ANT_HTML.INI FILE
  89.  
  90.  
  91. OPTION A:
  92.  
  93. 1.  Copy and paste the following into the ANT_HTML.INI file:
  94.     (Top of the file will be fine.  It's okay to have a
  95.     blank line first, if you want.)
  96.  
  97. -------Copy and paste text below-------
  98.  
  99. [LocalizedStyleNames]
  100. LocalVersion=
  101. Normal=
  102. Title=
  103. Heading=
  104. Platform=
  105. TemplatePath=
  106. PathDivider=
  107.  
  108. -------Copy and paste text above-------
  109.  
  110. Then...
  111.  
  112. 2.  Type the language version of Word you're using
  113.     after the equal sign of the "Local Version=" entry.
  114.     If you're not sure, click the Tools, Language in WORD
  115.     and see which language version is highlighted.)
  116.  
  117. 3.  For the "Normal=", "Title=", and "Heading=" entries,
  118.     enter "Normal", "Title", and "Heading" if you're
  119.     using an English language version of WORD.
  120.     If you're using a German, French, Spanich, Hebrew
  121.     or other international-language version of WORD,
  122.     enter the names of the Styles that are the equivalent
  123.     of the "Normal", "Title", and "Heading" WORD Styles
  124.     immediately after the "=" character.
  125.  
  126.  
  127. 4.  The "Platform=" entry should be
  128.     "Platform=Windows 3.10" or the equivalent which
  129.     indicates which environment and version number
  130.     you have.  I regret to report that there's no
  131.     simple way (other than the one used in the ANT_INST.DOC
  132.     file) to get the information if you don't already know 
  133.     what it is. 
  134.  
  135. 5.   The "TemplatePath=" entry can be found in your
  136.      WINWORD6.INI file (WINDOWS directory).  Open your 
  137.      WINWORD6.INI file and look for the entry which
  138.      reads "USER-DOT-PATH=" (+ your path).
  139.      It will look something like this:
  140.      "USER-DOT-PATH=C:\WINWORD\TEMPLATE"
  141.      (without the quotation marks).
  142.      Copy and paste the path portion after the
  143.      equal sign in the "TemplatePath=" entry
  144.      of your ANT_HTML.INI file (without any
  145.      quotation marks).
  146.  
  147.      If the very end of the path contains a ":" or a "\"
  148.      character, delete it from the entry in the ANT_HTML.INI
  149.      file. (DO NOT DELETE OR CHANGE ANYTHING IN YOUR WINWORD6.INI FILE.)
  150.  
  151. 6.   The "PathDivider=" entry is the relatively easy.
  152.      After the equal sign...
  153.      If you're using a Macintosh computer, type ":" 
  154.      If you're NOT using a Macintosh computer, type "\"
  155.      No matter what sort of computer you're using,
  156.      don't type the quotation marks.  Just type
  157.      a colon or a backslash.
  158.  
  159. 7.   That should do it. Now, save the ANT_HTML.INI file and close it.
  160.      (There'll be no need to bother about the ANT_HTML.INI file again.
  161.       Might be a good idea to save a copy of it in a different location,
  162.       just in case it accidentally is deleted.)
  163.  
  164.  
  165. To run the program, just...
  166. Open Word
  167. Select File, New
  168. When the dialog box asks you which template you want to base your
  169. document on, select the Ant template.
  170. Click OK.
  171. Two of the Ant's four toolbars should immediately appear and 
  172. you can begin creating an HTML document.
  173.      
  174. ``````````````````````````````````````````````````````````````````````````````````
  175.  
  176. OPTION B: Create Your Own Macro to Read the Paths
  177.  
  178. This option may or may not produce some of the horrid, scary messages.
  179. However, since all that's happening is that the macro is READING
  180. and NOT CHANGING the paths AND you can look up the commands to
  181. verify that this is the TRUTH of the matter, it's an alternative
  182. to consider if OPTION A, described above, seems a terrible pain.
  183.  
  184. If you have no experience writing macros, this might be helpful
  185. for future macro writing.  
  186.  
  187. 1.  Open Word
  188. 2.  If a new, blank document based on your regular "NORMAL.DOT"
  189.     template doesn't automatically appear, select FILE, NEW
  190.     and click OK so a blank document based on NORMAL.DOT appears.
  191. 3.  Select the Tools Menu, then Macro.
  192. 4.  In the Macro Name Box, type a name without any spaces.
  193.     "ApplicationInfo" will be fine.
  194. 5.  The "Create" button will become accessible as you type the
  195.     name of the macro.  Click the Create Button.
  196. 6.  A "Macro Window" will open and the words:
  197.     "Sub MAIN" will appear at the top, 
  198.     there's an empty paragraph mark and then the words:
  199.     "End Sub" appear at the bottom.
  200. 7.  Delete everything in the Macro Window and copy and paste
  201.     the following macro code instead:
  202.  
  203.     DO NOT add paragraph marks, spaces or ANYTHING to the macro.
  204.     Just copy and paste all the text, starting with the words
  205.     "Sub Main" through the words "End Sub" into the Macro Window.
  206.  
  207. '------------- Copy and Paste the Text Below -----------------
  208.  
  209. Sub MAIN
  210. On Error Goto ErrorTrap
  211. Insert "[LocalizedStyleNames]" + Chr$(13)
  212. LocalVersion$ = AppInfo$(16)
  213. Msg$ = "Local Version is: " + LocalVersion$
  214. MsgBox Msg$, "Local Version", 64
  215. Insert "LocalVersion=" + LocalVersion$ + Chr$(13)
  216. nsMsg$ = "If you're using an English language version of Word," + \
  217. "just click OK.  If not, enter the equivalent of Normal Style."
  218. nstyle$ = InputBox$(nsMsg$, "Equivalent of NORMAL Style ")
  219. If nstyle$ <> "" Then
  220.     Insert "Normal=" + nstyle$ + Chr$(13)
  221. Else
  222.     Insert "Normal=Normal" + Chr$(13)
  223. End If
  224. tsMsg$ = "If you're using an English language version of Word," + \
  225. "just click OK.  If not, enter the equivalent of Title Style"
  226. tstyle$ = InputBox$(tsMsg$, " Equivalent of TITLE Style ")
  227. If tstyle$ <> "" Then
  228.     Insert "Title=" + tstyle$ + Chr$(13)
  229. Else
  230.     Insert "Title=Title" + Chr$(13)
  231. End If
  232. hsMsg$ = "If you're using an English language version of Word," + \
  233. "just click OK.  If not, enter the equivalent of Heading Style."
  234. hstyle$ = InputBox$(hsMsg$, " Equivalent of HEADING Style ")
  235. If hstyle$ <> "" Then
  236.     Insert "Heading=" + hstyle$ + Chr$(13)
  237. Else
  238.     Insert "Heading=Heading" + Chr$(13)
  239. End If
  240. Platform$ = AppInfo$(1)
  241. PMsg$ = "Platform is: " + Platform$
  242. MsgBox PMsg$, "Platform", 64
  243. If InStr(Platform$, "Macintosh") Then PathDiv$ = ":" Else PathDiv$ = "\"
  244. Insert "Platform=" + Platform$ + Chr$(13)
  245. DOTPath$ = DefaultDir$(2)
  246. dpMsg$ = "USER-DOT-PATH is: " + DOTPATH$ + Chr$(13) + Chr$(13) + \
  247. "Is the LAST character in the DOT PATH on the line above " + \
  248. "one of these two characters: " + Chr$(34) + " : " + Chr$(34) + \
  249. " or " + Chr$(34) + " \ " + Chr$(34) + \
  250. Chr$(13) + "[Either a colon or a backslash] ?"
  251. dp = MsgBox(dpMsg$, "Last Character in the DOT PATH", 292)
  252. Insert "TemplatePath=" + DOTPath$
  253. If dp = - 1 Then
  254.     CharLeft(1, 1)
  255.     EditCut
  256.     Insert Chr$(13)
  257. Else
  258.     Insert Chr$(13)
  259. End If
  260. PDMsg$ = "Path Divider is: " + PathDiv$
  261. MsgBox PDMsg$, "Path Divider", 64
  262. Insert "PathDivider=" + PathDiv$
  263. FinalMsg$ = "Okay, All Done"
  264. MsgBox FinalMsg$, "The Macro is Finished", 64
  265. ErrorTrap:
  266.     If Err = 102 Then Goto Finish
  267.     Err = 0
  268. Finish:
  269. End Sub
  270.  
  271.  
  272. '------------- Copy and Paste the Text Above -----------------
  273.  
  274. 8.  Click File, Save and close the Macro Window.
  275. 9.  Click Tools, Macro, then the name of the macro you just
  276.     created, then click "RUN".
  277. 10. The paths (and answers to most of the questions which
  278.     belong after the equal signs in the ANT_HTML.INI file) 
  279.     will be entered into the blank document and also presented
  280.     to you in the form of Word Message Boxes. Several of
  281.     the Message Boxes will ask you questions.  Three questions
  282.     relate to Word Style Names.  If you're using an English language
  283.     version (U.S., British, Australian versions included), just
  284.     click OK when the question appears.  If you're using a German,
  285.     French, Spanish, Hebrew or other language version of Word, please
  286.     enter the Word Style Names which are the equivalent of
  287.     "Normal", "Title" and "Heading" styles in the dialog box and
  288.     then click OK.
  289. 12. When the macro has finished, copy and paste the
  290.     contents of the document, you have two choices...
  291.     a. Copy and paste the contents into the ANT_HTML.INI file
  292.          or
  293.     b. Save the file with the name "ANT_HTML.INI"
  294.        and make certain to select the "TEXT ONLY" setting
  295.        in the "Save File As Type" section (at the bottom of
  296.        the File Save Dialog Box).
  297.     The file should reside (or copied) to your WINDOWS
  298.     directory. Make sure it's there.
  299.  
  300. Okay, that should do it for OPTION B.
  301.  
  302.  
  303. To run the program, just...
  304. Open Word
  305. Select File, New
  306. When the dialog box asks you which template you want to base your
  307. document on, select the Ant template.
  308. Click OK.
  309. Two of the Ant's four toolbars should immediately appear and 
  310. you can begin creating an HTML document.
  311.  
  312. ------------------------------------------------------------------------
  313.  
  314. If something is amiss, it might be an uppercase/lowercase problem.
  315. Duplicate the case in the example that appears at the top of
  316. this page.
  317.  
  318. If you think it's ridiculous that Microsoft creates horrid, scary
  319. messages when a macro merely reads directory and system information, 
  320. you're not alone.  If you get peeved about it, I know how you feel.
  321. If you feel you must write to someone to complain about it, you know
  322. who to write. :)
  323.  
  324. `````````````````````````````````````````````````````````````````````
  325.                    The ATTACH ANT TEMPLATE Tool
  326.  
  327.    This is entirely optional and if you choose to add the tool,
  328.    it's a convenience, and does not affect the operation of the
  329.    program.
  330.  
  331.    If you want to add the "Attach Ant Template" Tool to your
  332.    Standard Toolbar, you just use the usual Word methods.
  333.    (The description of the tool can be found in the "ANT.HTM"
  334.     file.  View it in any Web browser.)
  335.    Here are the steps:
  336.  
  337. 1. Open Word
  338. 2. Select File, New
  339. 3. When the dialog box asks you which template you want to base your
  340.    document on, select the Ant template.
  341. 4. Click OK.
  342. 5. Choose Tools, Macro, Organizer
  343. 6. From the ANT's list of macros (on the left), select Attach ANT Template.
  344. 7. Make sure the NORMAL.DOT list of macros is on the right and
  345.    Choose Copy
  346. 8. Choose Close
  347.  
  348. You may then create a toolbar tool for the macro if you wish.
  349. (Use the usual Word method...)
  350.  
  351. 1. Select View, Toolbars, Customize
  352. 2. In the Categories Box, choose Macros
  353. 3. When the list of macros appears, select the Attach Ant Template macro
  354. 4. Hold the left mouse button down and drag the Attach Ant Template macro
  355.    to your Standard toolbar.  (Usually the topmost toolbar.)
  356. 5. Choose a toolbar button face and click Assign
  357.    or create one of your own by clicking Edit
  358. 6. Choose Close
  359.  
  360. Okay, it's done.
  361. Now, whenever you open Word, the button will be there, ready to
  362. start the Ant program quickly for you.
  363.  
  364. You can delete the macro and the toolbar tool whenever you like.
  365. To quickly delete macros and toolbar tools:
  366.  
  367. 1. In Word for Windows: Hold down the ALT key and drag the tool off the toolbar.
  368.    In Word for Macintosh, from the Tools Menu, choose Customize and then select
  369.    the Toolbars tab, then drag the tool from the Toolbar.
  370. 2. In the Tools Menu, choose Macro, then click on the "Attach Ant Template" entry
  371.    (or whatever macro you want to delete) and press the DELETE key.
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.